home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmTransferDone.z
/
XmTransferDone
Wrap
Text File
|
1998-10-30
|
9KB
|
133 lines
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee - A toolkit function that completes a data
transfer
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
vvvvooooiiiidddd XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(
XXXXttttPPPPooooiiiinnnntttteeeerrrr ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd,
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaattttuuuussss ssssttttaaaattttuuuussss);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee completes an already-initiated data transfer
operation. An application can call this routine from an
XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedure or any function called as a
result, including the selection procedures called as a
result of calls to XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee.
The caller of XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee supplies an identifier for the
transfer operation and an indication of the completion
status. XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee causes any remaining transfers for
the operation to be discarded.
ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd
Specifies a unique indentifier for the data
transfer operation. The value must be the same as
the value of the ttttrrrraaaannnnssssffffeeeerrrr____iiiidddd member of the
XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedure.
_s_t_a_t_u_s Specifies the completion status of the data
transfer. Following are the possible values:
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____SSSSUUUUCCCCCCCCEEEEEEEEDDDD
The transfer was completed successfully.
This status has the following additional
effects:
+o For a move operation, the
selection owner receives a request
to convert the selection to the
_D_E_L_E_T_E target.
+o If a _T_R_A_N_S_A_C_T operation is in
progress, the owner receives a
request to commit the transaction.
+o If a _P_E_R_S_I_S_T or ____MMMMOOOOTTTTIIIIFFFF____SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT
operation is in progress, the
Page 1 (printed 10/24/98)
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee((((3333XXXX))))
owner receives a notification that
the operation is finished.
+o The widget class destination
procedure is not called.
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____FFFFAAAAIIIILLLL
The transfer was completed
unsuccessfully. This status has the
following additional effects:
+o For a move operation, the
selection owner does not receive a
request to convert the selection
to the _D_E_L_E_T_E target.
+o For a drag and drop operation, the
DropTransfer's XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrSSSSttttaaaattttuuuussss
is set to XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____FFFFAAAAIIIILLLLUUUURRRREEEE.
+o If a _T_R_A_N_S_A_C_T operation is in
progress, the owner receives a
request to abort the transaction.
+o If a _P_E_R_S_I_S_T or ____MMMMOOOOTTTTIIIIFFFF____SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT
operation is in progress, the
owner receives a notification that
the operation is finished.
+o The widget class destination
procedure is not called.
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____CCCCOOOONNNNTTTTIIIINNNNUUUUEEEE
This status has the same effect as
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____SSSSUUUUCCCCCCCCEEEEEEEEDDDD, except that if
a _P_E_R_S_I_S_T or ____MMMMOOOOTTTTIIIIFFFF____SSSSNNNNAAAAPPPPSSSSHHHHOOOOTTTT operation
is in progress, the owner does not
receive a notification that the
operation is finished.
XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____DDDDEEEEFFFFAAAAUUUULLLLTTTT
The widget class destination procedure
is called. Further effects depend on
the actions of that procedure.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrSSSSeeeennnnddddRRRReeeeqqqquuuueeeesssstttt(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaarrrrttttRRRReeeeqqqquuuueeeesssstttt(3),
XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaarrrrttttRRRReeeeqqqquuuueeeesssstttt(3), and XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3).
Page 2 (printed 10/24/98)